home *** CD-ROM | disk | FTP | other *** search
/ Software USA 4 #11 / Software USA Volume 4.11.iso / mac / Educational / mac06 / usr / man / man1.2 / basename.1 < prev    next >
Encoding:
Text File  |  1998-02-15  |  4.1 KB  |  159 lines  |  [TEXT/ttxt]
  1. .TH snmp 1 "by HNS-LDV-TUM" "snmp access"
  2. .SH NAME
  3. snmpget  \- send GET request
  4. .br
  5. snmpnext \- send GETNEXT request
  6. .br
  7. snmpset  \- send SET request
  8. .br
  9. snmptable  \- retrieve and display full tables
  10. .br
  11. snmptrap \- send TRAP to manager
  12. .br
  13. snmpwalk \- retrieve and display full subtrees
  14.  
  15. .SH SYNOPSIS
  16. snmpget [ -dUovt ] [ -a agent:port:protocol ] [ -c community ] [ -w timeout ] { objid | -u url } ...
  17. .br
  18. snmpnext [ -dUovt ] [ -a agent:port:protocol ] [ -c community ] [ -w timeout ] { objid | -u url } ...
  19. .br
  20. snmpset [ -dUovt ] [ -a agent:port:protocol ] [ -c community ] [ -w timeout ] { objid | -u url } type value ...
  21. .br
  22. snmptable [ -dUovt ] [ -a agent:port:protocol ] [ -c community ] [ -w timeout ] [ -r retries ] objid | -u url
  23. .br
  24. snmptrap [ -dUovt ] [ -a agent:port:protocol ] [ -c community ] [ -w timeout ] enterprise agent [ { objid | -u url } type value ... ]
  25. .br
  26. snmpwalk [ -dUovt ] [ -a agent:port:protocol ] [ -c community ] [ -w timeout ] [ -r retries ] [ objid | -u url ]
  27.  
  28. .SH DESCRIPTION
  29. These programs can be called directly at the shell prompt to send SNMP
  30. requests to agents for 'barefooted' network management.
  31.  
  32. .SH OPTIONS
  33. .SS -a agent:port:protocol
  34. Specifies the agent to access.
  35. Its value defaults to the contents of the environment variable AGENT
  36. if defined
  37. or 'localhost:snmp:udp'.
  38.  
  39. .SS -c community
  40. Sets the community. 
  41. The default is 'public'.
  42.  
  43. .SS -w timeout
  44. Defines a timeout to wait for a response.
  45. The timeout is specified in seconds. Fractions with a resolution of 1 ms are permitted.
  46. The default is 5 seconds.
  47.  
  48. .SS -r retries
  49. Defines the number of retries for the walk operation until the client gives up.
  50. The default is 3.
  51.  
  52. .SS -g generic
  53. Defines the generic trap number (between 0 and 6).
  54. The default is 0.
  55.  
  56. .SS -s specific
  57. Defines the specific trap number.
  58. The default is 0.
  59.  
  60. .SS -T timestamp
  61. Defines the timestamp of the trap (in TIMETICKS).
  62. The default is 0.
  63.  
  64. .SS -d
  65. Dump all SNMP protocol data units sent and received on stderr.
  66.  
  67. .SS -u
  68. Dump all UDP service data units sent and received on stderr.
  69.  
  70. .SS -o
  71. Print object identifier of responses.
  72.  
  73. .SS -v
  74. Print value of responses.
  75.  
  76. .SS -t
  77. Print type of responses.
  78. If neither -o, -v, nor -t is specified, -otv is assumed.
  79.  
  80. .SS enterprise
  81. Specifies the enterprise OBJECT IDENTIFIER within a TRAP PDU.
  82.  
  83. .SS agent
  84. Specifies the agent address within a TRAP PDU.
  85.  
  86. .SS objid
  87. Specifies the object identifier to be accessed.
  88. For snmpwalk, this identifies the root of the subtree.
  89. For
  90. snmptable it specifies the TABLE_ENTRY node or the parent node of
  91. a group of non-tabular elements. Otherwise, strange formatting
  92. may occur.
  93.  
  94. .SS -u url
  95. may be used to specify the agent and the object identifier in a 
  96. single argument. The rules are as follows: The protocol must be 'snmp',
  97.  the host can be specified to override the host already 
  98. defined by an earlier -a or -u option and the object identifier 
  99. is separated by a slash (/). The request is sent to the last 
  100. agent specified.
  101.  
  102. .SS type
  103. Specifies the type of the value to be sent in a SET request or TRAP.
  104. Permitted types are (case insensitive):
  105. .br
  106. null, integer, gauge, counter, timeticks, ipaddr, octstr, objid.
  107.  
  108. .SS value
  109. Specifies the value to be sent in a SET request or TRAP.
  110. If the type is null, no value field is expected.
  111.  
  112. .SH EXAMPLES
  113.  
  114. snmpget -a localhost:snmp:udp 1.3.6.1.2.1.1.4
  115. .br
  116. snmpset -a localhost:snmp:udp 1.3.6.1.2.1.1.4.0 octstr "The new system"
  117. .br
  118. AGENT=myhost:snmp:udp; export AGENT
  119. .br
  120. snmpset -c set-community 1.3.6.1.4.1.860.1.1 integer 123
  121. .br
  122. snmpnext ''
  123. .br
  124. snmpwalk -r 5 1.3.6.1.4.1.860
  125. .br
  126. snmpwalk 
  127. .br
  128. snmptable 1.3.6.1.2.1.2.2.1
  129. .br
  130. snmptable 1.3.6.1.2.1.1
  131. .br
  132. snmptable -a localhost:snmp:udp -ov 1.3.6.1.2.1.3.1.1
  133. .br
  134. snmptable -ov -u snmp://localhost/1.3.6.1.2.1.3.1.1
  135. .br
  136. snmptrap -w 0 -g 1 -a manager:162:udp 1.3.6.1.4.1.860 localhost
  137. .br
  138. snmpwalk -u snmp://myhost/1.3.6.1.2.1.3.1.1
  139. .br
  140. snmpwalk -u snmp:1.3.6.1.2.1.3.1.1
  141.  
  142. .SH ENVIRONMENT
  143. AGENT    may be set to override the default of the -a option
  144.  
  145. .SH SEE ALSO
  146. SNMPt(3SNMPt).
  147.  
  148. .SH BUGS
  149. There is always one more bug (Murphy).
  150.  
  151. .SH AUTHOR
  152. H. Nikolaus Schaller
  153. .br
  154. Lehrstuhl fuer Datenverarbeitung
  155. .br
  156. TU-Muenchen
  157. .br
  158. hns@ldv.e-technik.tu-muenchen.de
  159.